Events
The Events section provides a unified view of all raw data events received from devices and telematics providers — GPS readings, OBD-II diagnostics, sensor values, and system events from connected fleet hardware.
Event Types
| Event Type | Description |
|---|---|
| Position Update | GPS coordinate update from a GPS tracker or telematics modem |
| OBD-II Reading | Engine diagnostic data (RPM, fuel, coolant temp, fault codes) |
| Temperature Reading | Cargo or ambient temperature value from a temperature sensor |
| Door Event | Cargo door opened or closed |
| Motion Event | Vibration, impact, or G-force detected |
| Speed Alert | Vehicle exceeded a configured speed threshold |
| Geofence Event | Vehicle entered or exited a defined geofence area |
| Fault Code | OBD-II diagnostic trouble code (DTC) reported by the vehicle |
| Device Heartbeat | Periodic keep-alive signal confirming the device is online |
Accessing Events
Navigate to Fleet Management → Connectivity → Events.
Filter the event list by:
- Device — show events from a specific hardware unit
- Vehicle — show all events for a specific vehicle
- Event Type — filter to a specific event category
- Date Range — narrow to a time window
Event Payload
Each event record contains:
| Field | Description |
|---|---|
id | Unique event identifier |
device_id | Originating device |
vehicle_id | Vehicle the device is installed in |
event_type | Type of event (see table above) |
timestamp | UTC timestamp of the event |
location | GeoJSON Point (coordinates where event occurred) |
data | Event-specific payload (sensor value, OBD reading, etc.) |
API Access
Retrieve device events programmatically:
GET /int/v1/fleet-ops/devices/{device_id}/events
Filter parameters: event_type, start_date, end_date, vehicle_id.
Use Cases
| Use Case | How Events Help |
|---|---|
| Accident reconstruction | Replay position history with speed and G-force data around the time of an incident |
| Unauthorized use detection | Identify movement events outside shift hours |
| Cold chain breach identification | Find the exact time, location, and value of a temperature breach |
| Excessive idling analysis | Detect prolonged engine-on events without movement |
| Fuel theft detection | Correlate fuel level drops with position history |
Retention
Event records are retained according to your Mative Cloud storage policy. For long-term compliance and analytics, events can be exported to CSV or forwarded to Synapsis Analysis for deeper processing.